home *** CD-ROM | disk | FTP | other *** search
/ HTBasic 9.3 / HTBasic 9.3.iso / SICL / readme.txt < prev    next >
Text File  |  2001-03-02  |  15KB  |  321 lines
  1. Agilent IO Libraries for Windows
  2.      Version J.02.00.01
  3.  
  4. This file contains the following:
  5.    * General Information  
  6.    * New Features
  7.    * Fixes
  8.    * Issues 
  9.    * Contact Support 
  10.    * Downloading the Latest Version of the Agilent IO Libraries
  11.  
  12. General Information  
  13. ===================
  14.  
  15. This IO Libraries package supports Windows 95, Windows 98,
  16. Windows NT and Windows 2000.
  17.  
  18. After you have installed the Agilent IO Libraries, you can double-
  19. click on the 'IO Readme' icon in the 'Agilent IO Libraries' folder
  20. to view the latest information about the Agilent IO Libraries.
  21.  
  22. These information and troubleshooting files are in HTML format and
  23. reside in the 'readme' subdirectory of the main IO Libraries
  24. installation directory.  If you have installed the IO Libraries in
  25. the default location, these files are located in:
  26.  
  27.    - C:\Program Files\Agilent\IO Libraries
  28.  
  29. These files are also present in the 'readme' subdirectory on the
  30. Agilent IO Libraries CD-ROM.
  31.  
  32. Note that you must have a web browser installed on your computer
  33. to view these files.
  34.  
  35. Electronic manuals are also included on the CD-ROM in the 'Manuals'
  36. subdirectory.  Setup options also allow you to install these
  37. manuals on the hard drive.  They are installed in the 'Manuals'
  38. subidrectory of the main IO Libraries installation directory.
  39.  
  40. To view the electronic manuals that are included with IO Libraries
  41. you will need Adobe Acrobat Reader version 3.01 or later installed 
  42. on your computer.  You can obtain the latest Acrobat Reader from 
  43. Adobe's web site at: http://www.adobe.com by clicking on the 'Get
  44. Acrobat Reader' icon.  
  45.  
  46. Adobe Acrobat Reader can also be installed from the IO Libraries
  47. CD-ROM.  Double-click on the icon in the 'Adobe' subdirectory of
  48. the CD-ROM to install it.
  49.  
  50.  
  51. New Features
  52. ============
  53.  
  54.    - Support for Windows Me has been added.
  55.      * Note that due to Windows configuration manager changes
  56.        made by Microsoft, the 82341C ISA GPIB card and the
  57.        E2075 ISA GPIO card are not supported on Windows Me.
  58.  
  59.    - Two new request codes are available for the iserialctrl()
  60.      function in SICL.
  61.      * I_SERIAL_IN_DISCARD - The following actions will occur:
  62.        = The data in the serial input buffer will be discarded
  63.        = Any error conditions will be reset.
  64.      * I_SERIAL_OUT_DISCARD - The following actions will occur:
  65.        = Any pending writes will be aborted.
  66.        = The data in the serial output buffer will be discarded
  67.        = Any error conditions will be reset.
  68.  
  69.    - Three new request codes are available for the iserialstat()
  70.      and iserialctrl() function in SICL.
  71.      * I_SERIAL_XON_CHAR
  72.        = Get / Change the character used for stopping transmission
  73.          when using software handshaking.  The default is 0x11.
  74.      * I_SERIAL_XOFF_CHAR
  75.        = Get / Change the character used for re-starting transmission
  76.          when using software handshaking.  The default is 0x13.
  77.      * I_SERIAL_REPLACE_CHAR
  78.        = Get / Change the character used to represent a 'bad' received
  79.          character (e.g. parity error).  The default is 0xff.
  80.  
  81.    - Since version J.01.00, the IO Libraries installation program will
  82.      detect the presence of National Instruments VISA and will default
  83.      to installing only SICL in this case so we will not overwrite
  84.      NI-VISA.  You can force Agilent VISA to overwrite NI-VISA by
  85.      selecting the 'Full SICL and Agilent VISA Installation' menu
  86.      choice when installing the IO Libraries. 
  87.  
  88. Fixes
  89. =====
  90.  
  91.    - In the viFlush() VISA function, it is now possible to discard
  92.      the ASRL in and out buffers separately.
  93.      * VI_ASRL_IN_BUF_DISCARD and VI_ASRL_OUT_BUF_DISCARD no
  94.        longer need to always be set together.
  95.      * If only one is set, VI_ERROR_INV_MASK no longer returned.
  96.  
  97.    - The following attributes are  now supported with the VISA
  98.      functions viGetAttribute() and viSetAttribute() for ASRL sessions:
  99.      = VI_ATTR_ASRL_XON_CHAR
  100.      = VI_ATTR_ASRL_XOFF_CHAR
  101.      = VI_ATTR_ASRL_REPLACE_CHAR
  102.  
  103.    - If there are no IRQ's  available for an auto-configured 82341C
  104.      ISA GPIB card, a dialog box is presented when the
  105.      IO Configuration program is run.  Previously no indication was
  106.      given but the card would not work.
  107.  
  108.    - SICL LAN Client with the host specified by IP address, no longer
  109.      requires an entry in the HOSTS table.
  110.  
  111.    - The IO Configuration program no longer displays configuration
  112.      warnings when uninstalling the IO Libraries.
  113.  
  114.    - The IO Libraries setup program no longer fails if msvcrt.dll is
  115.      not installed on the system.
  116.  
  117.    - Some bad shortcuts in the Agilent IO Libraries and VXIPNP program
  118.      folders have been fixed.
  119.  
  120.    - Some defects in the E8491 VXI Resource Manager program have been
  121.      fixed.
  122.  
  123.    - The 'actualcnt' parameter returned by iwrite() in a commander
  124.      session to a GPIB device now returns the correct value.  It used
  125.      to return a large apparently random number if a timeout occurred
  126.      before any bytes were sent. This problem also affected viWrite().  
  127.  
  128.  
  129. Issues
  130. ======
  131.  
  132.    - 82341C GPIB cards and E2075A GPIO cards are not supported on
  133.      Windows Me.
  134.      * Due to Windows configuration manager changes made by Microsoft,
  135.        these ISA cards are very difficult to configure and can cause
  136.        the computer to hang during the configuration process.
  137.        Refer to the html troubleshooting page for more information.
  138.  
  139.    - The 82341D GPIB card is not supported on Windows 2000.
  140.      * Note, however, that the 82341C card is supported.
  141.  
  142.    - The Adaptec PCI to 1394 card which originally shipped with
  143.      the E8491 VXI to 1394 interface is not supported on Windows 2000.
  144.      * This original card was not OHCI compliant and only OHCI 1394
  145.        cards are supported on Windows 2000.
  146.      * The E8491 is now shipping with an OHCI compliant card which is
  147.        supported on Windows 2000.
  148.  
  149.    - Beginning with the J.01.00 release, the default paths for
  150.      IO Libraries and VISA have changed to:
  151.       '\Program Files\Agilent\IO Libraries' for SICL
  152.       '\Program Files\VISA' for VISA
  153.      If you are installing over a previous version of the
  154.      IO Libraries, the directories will not be changed.
  155.  
  156.    - We recommend downloading a Windows 2000 hotfix from Microsoft to 
  157.      resolve two known problems which affect the E8491.
  158.      * Block write and I-SCPI performance on the E8491 on Windows 2000
  159.        are significantly reduced due to the workaround for a memory
  160.        leak in the 1394 driver.
  161.      * Performance problems and missed interrupts on Windows 2000 are
  162.        possible due to a busy-acknowledge defect in the 1394 driver.
  163.        This is known to affect some E8491 firmware downloads and some
  164.        I-SCPI and VXIplug&play drivers.
  165.      * Microsoft has implemented a hotfix which solves both of these
  166.        problems.  Go to 
  167.           http://www.microsoft.com
  168.        and search for 'Q262814' to find the Knowledge Base article with
  169.        information on obtaining the hotfix.  If you have difficulty,
  170.        contact Agilent Support for more information.
  171.      * The hotfix must be obtained from Microsoft.  Microsoft does not
  172.        allow Agilent to distribute Windows 2000 hotfixes.
  173.      * Microsoft has stated that this fix will be included in the
  174.        Windows 2000 Service Pack 2 when it becomes available.
  175.      * The E8491 driver will sense the presence of the hotfix or
  176.        Service Pack 2 and automatically switch to a higher performance
  177.        mode if either is installed.
  178.  
  179.    - We recommend downloading a Windows 98/Me hotfix from Microsoft to 
  180.      resolve a known Windows 98/Me IEEE 1394 problem which affects the
  181.      E8491.
  182.      * Performance problems and missed interrupts on Windows 98 and
  183.        Windows Me are possible due to a busy-acknowledge defect in the
  184.        1394 driver.  This is known to affect some E8491 firmware
  185.        downloads and some I-SCPI and VXIplug&play drivers. 
  186.      * Microsoft has implemented a hotfix which solves this problem.
  187.        You can find out more about this hotfix by going to
  188.           http://www.microsoft.com
  189.        and searching for Q252185 to find the Knowledge Base information
  190.        on obtaining the hotfix.  If you have difficulty, contact Agilent
  191.        Support for more information. 
  192.      * The hotfix must be obtained from Microsoft.  Microsoft does not
  193.        allow Agilent to distribute Windows hotfixes.  
  194.  
  195.    - There is a memory leak in Windows 98 which may affect the
  196.      IO Libraries operation.
  197.      * We have observed a 4 Kb memory leak each time any program that
  198.        dynamically links the Microsoft msvcrt.dll (even a program that
  199.        does not do IO) is run and then exits on Windows 98.  This DLL
  200.        is the C runtime library supplied with Microsoft Visual Studio
  201.        and it is used by many products.
  202.      * The IO Libraries dynamically link to msvcrt.dll so any program
  203.        using SICL and / or Agilent VISA will exhibit this problem.
  204.      * If your application involves starting and stopping programs many
  205.        times, you will eventually run out of memory.  Windows 98 will
  206.        gradually become sluggish and eventually quit.  The only solution
  207.        to this problem is to reboot.
  208.      * We are reporting this defect to Microsoft but there is no
  209.        resolution yet available.
  210.      * Note: If in Microsoft Visual Studio, you choose
  211.              'Multithreaded DLL' in the 'Use run-time library:' box
  212.              on the C/C++ Code Generation tab, your application will
  213.              dynamically load msvcrt.dll. 
  214.  
  215.    - When three or more E8491's are connected to a single IEEE 1394
  216.      interface card, certain topologies may not work. 
  217.      * In certain topologies the E8491 hardware is not properly
  218.        identified on the 1394 bus.  This will result in inconsistent
  219.        behavior when the VXI resource manager tries to configure
  220.        instruments in the VXI card cages.   
  221.      * Behavior may include timeout errors while attempting to
  222.        communicate with a particular instrument, and / or instruments
  223.        appearing in cages where they are not actually located. 
  224.      * Try reversing the cable connections to the ports on the host
  225.        interface card.  In general, cable connections with longer chains
  226.        of E8491's should be on lower host ports. 
  227.  
  228.    - Don't re-run setup too quickly.
  229.      * After the IO Libraries Setup program exits, it takes several
  230.        seconds to clean up and unload itself from memory.  If Setup
  231.        is re-run before this process is complete, you may see an
  232.        error message or find that the re-installation does not
  233.        behave as expected.
  234.      * Be sure to wait until the 'InstallShield Wizard' box on the
  235.        Windows task bar has disappeared before attempting to re-run
  236.        the IO Libraries Setup.
  237.  
  238.    - Installing on dual boot systems can cause problems.
  239.      * Installing the IO Libraries on dual boot systems that share a
  240.        common 'Program Files' directory between two operating systems
  241.        is not recommended and may cause problems.
  242.      * If the IO Libraries are installed in the same directory for both
  243.        operating systems (e.g. 'Program Files\Agilent\IO Libraries'),
  244.        files for one OS may overwrite files for the other OS.
  245.      * InstallShield uses a directory under 'Program Files' to log the
  246.        name and location of files for later un-installation as well as
  247.        the components that are currently installed.  Uninstalling or
  248.        modifying an installation on one OS may affect the files for the
  249.        other OS rather that the currently booted OS, even if these
  250.        files are installed in different directories.
  251.  
  252.    - The syntax for specifying an option with the self-installing .exe
  253.      file 'iolibs.exe' is different from specifying a parameter with
  254.      Setup.exe on the CD.
  255.      * To specify options to Setup, invoke Setup from a command prompt
  256.        and separate the options with spaces:
  257.           e.g. 'setup auto novisa'
  258.      * When installing from the self-installing .exe file, you must
  259.        include a '-a' option as the first option:
  260.           e.g. 'iolibs -a auto novisa'
  261.  
  262.    - Setup from the self-installing .exe file may prompt for bogus disk.
  263.      * If you install the IO Libraries from the self-installing .exe
  264.        file using a parameter (e.g. 'iolibs -a auto'), you may be
  265.        prompted to insert a non-existent disk.
  266.      * You may continue the installation by specifying the last
  267.        available disk in the set.
  268.  
  269.    - After installation on Windows 95 and Windows 98, Windows may fail
  270.      to boot.
  271.      * When adding paths to the PATH statement in Autoexec.bat,
  272.        InstallShield does not recognize '@PATH' as a path statement.
  273.        It will create a second 'SET PATH' statement.  If there is a
  274.        second PATH statement, it will replace the existing Windows
  275.        PATH and end up removing the Windows directories from the PATH.
  276.      * If Windows fails to boot with a message 'Cannot find WIN.COM,
  277.        unable to continue loading Windows', you will need to edit the
  278.        additional PATH statement in Autoexec.bat so the Windows
  279.        directories are again included in the PATH.
  280.        = From the DOS prompt type:
  281.            'c:\windows\command\edit c:\autoexec.bat'.
  282.          (Substitute the actual paths if you have a non-standard
  283.          installation.)
  284.        = Find the last 'SET PATH=...' statement and insert '%path%;'
  285.          immediately after the equals sign.  (e.g. 'SET PATH=%path%;...'
  286.          and don't forget the semi-colon separator.)
  287.        = Save the modified file and reboot.  Windows should now boot
  288.          normally.
  289.  
  290.    - If the E8491 is very busy and an IEEE 1394 bus reset occurs, it may
  291.      become unresponsive and require a reset of the E8491 and/or a reboot
  292.      of the computer. 
  293.      * This problem can occur when another 1394 device is added or removed
  294.        while the E8491 is busy.
  295.  
  296.  
  297. Contact Support 
  298. ===============
  299.  
  300.    - The Agilent IO Libraries support web page is:
  301.         'http://www.agilent.com/find/iolib_support'
  302.  
  303.    - For Telephone support:
  304.      * In the US, the phone number for support is 800-452-4844. 
  305.      * In the Canada, the phone number for support is 877-894-4414. 
  306.      * Outside the US and Canada, contact your country's Agilent
  307.        support organization.  A list of contact information for other
  308.        countries is available on the Agilent website at:
  309.          'http://www.agilent.com/find/assist'. 
  310.  
  311.  
  312. Downloading the Latest Version of the Agilent IO Libraries
  313. ==========================================================
  314.  
  315.    - You can download the latest released version of the Agilent IO
  316.      Libraries from:
  317.          'http://www.agilent.com/find/iolib'
  318.  
  319.  
  320. Copyright 2000 Agilent Technologies. All Rights Reserved.
  321.